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be sianed and dated by fte inventorfs) and wttness(es). 


A. 


Description of the construction and operation of the invention (include appropriate schematic, block, & timing diagrams; drawings; samples; 
graphs; flowcharts; computer listings; test results; etc.) 


B. 


Advantages of the invention over what has been done before. 


C. 


Problems solved by the invention. 


D. 


Prior solutions and their disadvantages (if available, attach copies of product literature, technical articles, patents, etc.). 
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Description of Invention 
A. 

The JMS tag handler class (MessageTag) uses an instance of a MessageUtils object A MessageUtils object can 
either be a TopicUtils object, QueueUtils object, or some other extension of MessageUtils, The tag handler class 
creates and uses the appropriate MessageUtils extension to send a JMS message based on which combination of 
attributes are specified on the tag. The UML diagram below describes the architecture. 



MessageTag 



MessageUtils 



+MessageUtils() 
+setConnectionFactory(in cf : ConnectionFactory) 
+setDestination(in dest : Destination) 
+setMessage(in message : String) 
+setDeliveryMode(in mode : int) 
+setPriority(ln p : int) 
+setTimeToLive(in ttl : long) 
+setArgs(in args : Object Q) 



«extc nds= 



«ext( nds» 





TopicUtils 




QueueUtils 








+publish() 


+send() 



In a JSP page, the tag can be used with several different combinations of attributes. Below is a diagram of the use 
cases, showing which combinations of attributes can be specified for success and failure cases. 
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Success Cases - Attributes specified 



Failure Cases - Attributes specified 
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8#* 

In a JSP, the &8«2^ success case would look like this: 
<%@ taglib uri= M /WEB-INF/blsw.tld" prefix="hp" %> 

<hp:jmsMessage topicConnectionFacto^'^vaxomp/env/jms/topicConnectionFactory" 
topic="sampleTopic" > 

This is the message (or JMS Message payload) being sent. 
</hp:jmsMessage> 

B. 

Never before has anyone combined JMS technology with JSP custom tag technology. With the JSP tag 
described within, the JSP page author can program messages to be sent when the JSP is executed in the JSP 
container via the use of a simple JMS tag, rather than having to write java code in a scriptlet in the JSP to 
accomplish the same task. 

C. 

The problem of how to send a JMS message from a JSP page without having to write any Java code is 
solved via this new JMS tag. 

D. 

The old way of sending a JMS message from a JSP page to a Topic would be to write code like the 
following: 

<% 

Initial Con text ctx = new InitialContext ( ) ; 
TopicConnectionFactory tcf = 

(TopicConnectionFactory) ctx. lookup ( "TopicConnectionFactory") ; 
Topi cConnect ion conn = tcf . createTopicConnection () ; 
TopicSession session = conn . createTopicSession (false , 
Top i c S e s s i on . AUTO_ACKNOWLEDGE ) ; 
Topic topic = session. createTopic ("/test") ; 

TopicPublisher pub = session . createPublisher ( topic ); 
TextMessage m =s session . createTextMessage (someMessage) ; 
pub.publish(m) ; 
conn. closet) ; 
%> 

The disadvantage of this is that the page author must: 

1 . Know how to program in Java 

2. Be familiar with the JMS API 

3. Be familiar with the JNDI API 



, Redacted 



